How to install Capella and Addons ?

Capella Installation

Prerequisites Needed for Install

For a successful installation of Capella, your computer must meet the following recommended requirements:

• 64 bit computer running Windows 7/8/10, Windows Server 2008/2012/2016
• An unzip software such as 7Zip or equivalent
• 2 GHz processor
• 4 Go RAM
• 15 GB of available hard disk space

Capella requires a Java Runtime Environment (version 1.8 or later) installed in the computer: Recommended version is JRE 8u121

Capella Installation Procedure

Before starting the installation, the target location of Capella must be cleaned:

1. The previous Capella version must be correctly uninstalled (See related section)
2. All manual patches/extensions must be removed
3. Download Capella and extract it in a given directory

Note : See Restriction

Verification Installation Procedure

The Capella installation is successful if the archive extraction finished without errors.

• The Capella folder should contain two folders:
  • eclipse: the Capella modeling workbench with the .exe of Capella
  • samples: the sample models

Workaround to open the Help Content when there is problem with the browser

Sometimes due to security policy, the web browser has problem on opening local host web pages. This is the case of the Help Content page when it is accessed via the 127.0.0.1 IP address. Here are 2 possible workarounds to overcome this problem:

• In the URL, replace 127.0.0.1 by localhost.
• Copy the URL and paste it in another web browser without restriction.

Addons Installation

There are 3 ways to install addons :

1. Simple installation
   • Install the addons directly in the dropins folder of Capella :
   1. Unzip the archive of the addon in your Capella "dropins" directory
2. External installation
   • Install the addons in an external directory and configure Capella to get them from this specific directory :
   1. Unzip the archive of the addon in a directory
   2. Add -Dorg.eclipse.equinox.p2.reconciler.dropins.directory=<myAddonsDirectory> at the end of the eclipse.ini file (after -vm)
3. Multiple contexts installation
   • Create several contexts with specific addons and allow users to launch Capella on one or another context :
     1. Create contexts directories (copy eclipse.ini from Capella and unzip the needed addons in a dropins folder).
     2. For each context, change the eclipse.ini file as follows:

• For Context_A, add the following lines at the end of the eclipse.ini file (afer -vm)-(Example)

• For Context_B, add the following lines at the end of the eclipse.ini file (afer -vm)-(Example)

• Create shortcuts to launch Capella using the eclipse.ini file stored in the expected context:
  • For context A: <CAPELLA_INSTALLATION_DIR>\eclipse\eclipse.exe --launcher.ini D:\CapellaContexts\Context_A\eclipse.ini
  • For context B: <CAPELLA_INSTALLATION_DIR>\eclipse\eclipse.exe --launcher.ini D:\CapellaContexts\Context_B\eclipse.ini

The extensions for Capella requires the installation of the following software:

• Capella : For the Capella installation, please refer to this guide

Note:Make sure that the addon/extension is compatible with your current version of Capella.

Addons

The installation procedure is the same for all addons.

As Dropin

To manually install your addon:

• Download the addon as a dropin
• Extract the contents of the downloaded archive into <CAPELLA_INSTALLATION_DIR>/eclipse/dropins directory

Check that the extraction process has finished without error.

• Start Capella

As Update Site

• Download the addon as an update site
• Start Capella
• Open Help using the menu toolbar
• Select Install New Software
• A wizard is displayed
• Click on Add button
• Click on Archive... button
• Select the downloaded addon archive and press OK
• Give it a name and press OK
• Click on Select All button then Next
• Agree and click on Finish
• Restart when prompted

Verification

The following procedure for verifying the successful installation of addons, assumes that Capella is well installed and fully functional.

Plugins Verification

• Start Capella with the option -clean. It forces the application to clear the cached data and to rebuild its configuration after installing a plug-in.
• Open Help using the menu toolbar
• Select About Capella
• Select Installation Details
• Select Plugins tab
• Scroll down the list
• Check that the plugins that correspond to the add-on are displayed.
• Open Error Log view and verify there is not any error message relating to the installed add-on.
• If no problem happens, remove this -clean parameter to avoid starting performance issues for next times.

Restriction